Token Denoms

Queries the available token denoms for the specified token Id on the specified chains.

query Token_denoms($denom: String, $tokenId: String, $chainUids: [String!]) {
  token {
    token_denoms(denom: $denom, token_id: $tokenId, chain_uids: $chainUids) {
      denoms {
        id
        chain_uid
        token_type {
          ... on NativeTokenType {
            native {
              denom
            }
          }
          ... on SmartTokenType {
            smart {
              contract_address
            }
          }
          ... on VoucherTokenType {
            voucher
          }
        }
        chain_type
      }
      id
      token_id
    }
  }
}

Example

curl --request POST \
    --header 'content-type: application/json' \
    --url 'https://api.euclidprotocol.com/graphql' \
    --data '{"query":"query Token_denoms($denom: String, $tokenId: String, $chainUids: [String!]) {\n  token {\n    token_denoms(denom: $denom, token_id: $tokenId, chain_uids: $chainUids) {\n      denoms {\n        id\n        chain_uid\n        token_type {\n          ... on NativeTokenType {\n            native {\n              denom\n            }\n          }\n          ... on SmartTokenType {\n            smart {\n              contract_address\n            }\n          }\n          ... on VoucherTokenType {\n            voucher\n          }\n        }\n        chain_type\n      }\n      id\n      token_id\n    }\n  }\n}","variables":{"denom":"eth","tokenId":null,"chainUids":null}}'

Open in Playground

Example Response

{
  "data": {
    "token": {
      "token_denoms": [
        {
          "denoms": [
            {
              "id": "TokenDenomWithChainType:ethereum:evm:native:eth",
              "chain_uid": "ethereum",
              "token_type": {
                "native": {
                  "denom": "eth"
                }
              },
              "chain_type": "evm"
            },
            {
              "id": "TokenDenomWithChainType:arbitrum:evm:native:eth",
              "chain_uid": "arbitrum",
              "token_type": {
                "native": {
                  "denom": "eth"
                }
              },
              "chain_type": "evm"
            },
            {
              "id": "TokenDenomWithChainType:optimism:evm:native:eth",
              "chain_uid": "optimism",
              "token_type": {
                "native": {
                  "denom": "eth"
                }
              },
              "chain_type": "evm"
            },
            {
              "id": "TokenDenomWithChainType:base:evm:native:eth",
              "chain_uid": "base",
              "token_type": {
                "native": {
                  "denom": "eth"
                }
              },
              "chain_type": "evm"
            }
          ],
          "id": "TokenDenomWithTokenIDResponse:eth",
          "token_id": "eth"
        }
      ]
    }
  }
}

Arguments

Argument	Type	Description
denom	String	Optional filter to match a specific token denomination.
tokenId	String	Optional filter to match a specific token identifier.
chainUids	[String!]	Optional list of chain UIDs to filter the token denoms by chain.

Return Fields

Field	Type	Description
id	String	Unique identifier for the token denom response object.
token_id	String	The token identifier being queried.
denoms	Denom[]	Token representations available across the matching chains.

Denom

Field	Type	Description
id	String	Unique identifier for the denom entry.
chain_uid	String	The chain UID where this token representation exists.
token_type	TokenType	The token representation on that chain.
chain_type	String	The chain family for this denom entry, for example evm or cosmwasm.

TokenType

Field	Type	Description
native	Native	Details of native token denoms.
smart	Smart	Details of smart-token contract addresses.
voucher	JSON	Voucher marker payload for voucher token representations.

Native

Field	Type	Description
denom	String	The denomination of the native token.

Smart

Field	Type	Description
contract_address	String!	The contract address of the smart token.